Node / meshtastic / Meshtastic-Android / files / .github / copilot-instructions.md

Displaying Raw • View rendered • Download

Tc9d1d9# Meshtastic Android - GitHub Copilot Guide

Tff7b72> **Note:** The canonical instructions for all AI Agents have been deduplicated.

You MUST immediately read and internalize the unified instructions located at the root of the repository in Ta5d6ff`AGENTS.md`.

After reading Ta5d6ff`AGENTS.md`, consult the Ta5d6ff`.skills/` directory for task-specific playbooks.

Tc9d1d9## Critical reminders (do not skip)

These rules live in Ta5d6ff`AGENTS.md` but are inlined here because past sessions repeatedly violated them:

Tff7b72- **Never modify Ta5d6ff`core/proto/src/main/proto/*.proto`** — it's an upstream submodule. If a feature needs a proto change, stop and label the issue Ta5d6ff`upstream` pointing at Ta5d6ff`meshtastic/protobufs`.

Tff7b72- **Verify-then-push, never "should be green".** Before any Ta5d6ff`git push`, run Ta5d6ff`./gradlew spotlessApply detekt` plus relevant Ta5d6ff`:module:test` for touched modules. After pushing, do **not** claim CI is green based on assumption — fetch the actual status with Ta5d6ff`gh pr checks <PR>` (or Ta5d6ff`gh run list --branch <branch> --limit 5`) and only report success once the checks return ✅. Phrases like "CI should be green now" are banned.

Tc9d1d9## Tooling conventions

Tff7b72- **Engage the `android-cli` skill automatically.** Whenever the user mentions adb, emulator, device install/run, screenshots, or named devices (e.g. Ta5d6ff`1c10`, Ta5d6ff`Pixel 6a`), invoke the Ta5d6ff`android-cli` skill *before* running raw Ta5d6ff`adb` or Ta5d6ff`gradle install*` commands. Don't wait for the user to paste the skill-context block.

Tff7b72- **Screenshots and ad-hoc artifacts go to `/tmp/`.** Never write annotated screenshots, log dumps, or scratch files into the repo working tree — they pollute Ta5d6ff`git status` and risk accidental commits. Use Ta5d6ff`/tmp/` or the session workspace (Ta5d6ff`~/.copilot/session-state/<id>/files/`).